###Function###
FileWrite

###Description###
Schreibt Text/Daten an das Ende einer zuvor geffneten Textdatei.

###Syntax###
FileWrite ( "filehandle/filename", "text/data" )


###Parameters###
@@ParamTable@@
filehandle/filename
	Das Handle der Datei, wie es von einem frheren Aufruf von <a href="FileOpen.htm">FileOpen()</a> zurckgegeben wurde. Alternativ kann ein String mit dem Dateinamen als erster Parameter verwendet werden.
text/data
	Der Text/Die Daten, die in die Datei geschrieben werden soll(en). Die Zeile wird so wie sie ist in die Datei geschrieben. Es wird kein @CR oder @LF angehngt. Siehe Bemerkungen fr die Datentypen.
@@End@@

###ReturnValue###
@@ReturnTable@@
Erfolg:	1.
Fehler:	0 wenn die Datei nicht im writemode geffnet wurde, die Datei schreibgeschtzt ist oder sie aus anderen Grnden nicht beschrieben werden konnte.
@@End@@


###Remarks###
Die Datei muss im Schreibmodus (write mode) geffnet sein, damit <a href="FileWrite.htm">FileWrite()</a> keinen Fehler hervorruft.

Wenn ein Dateiname statt eines Dateihandles angegeben wird, wird die Datei whrend des Funktionsaufrufes geffnet und geschlossen. Wenn man groe Textdateien bearbeitet, ist das natrlich viel langsamer als die Arbeit mit Handles. Die Datei wird erstellt, wenn sie noch nicht existiert.

Hinweis: Die Verwendung von Dateihandles und -namen sollte nicht vermischt werden. So sollte man z.B. vermeiden, eine Datei mit <a href="FileOpen.htm">FileOpen()</a> zu ffnen und dann in dieser Funktion einen Dateinamen verwenden. Es sind entweder Handles oder Dateinamen zu benutzen - nicht beides.

AutoIt schreibt Text standardmig mit ANSI Kodierung. Um in Unicode Kodierung zu schreiben, muss die Datei mit <a href="FileOpen.htm">FileOpen()</a> unter Verwendung der notwendigen Flags geffnet werden.

Wenn die Daten ein binrer Datentyp (und kein Text) sind, wird byteweise in die Datei geschrieben. Der Binrmode kann auch durch Aufruf von <a href="FileOpen.htm">FileOpen()</a> mit dem Binrmode Flag erzwungen werden.

Mit der Funktion _FileWriteToLine kann man auch an einer ganz bestimmten Stelle in einer Datei schreiben (z. B. an den Anfang der Datei)


###Related###
FileFlush, FileOpen, FileRead, FileReadLine, FileWriteLine, Binary, FileSetPos, FileGetPos


###Example###
@@IncludeExample@@
